home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / graphics / viewgf12.lzh / VIEWGF12.DOC next >
Text File  |  1990-11-01  |  42KB  |  1,061 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                             VIEWGIF (Version 1.2) 
  8.  
  9.                     Copyright 1990 by Craig S. Buchanan 
  10.          
  11.                                 SHAREWARE 
  12.  
  13. This program is copyrighted software. This program and its documentation may
  14. be freely copied and shared with others, as long as no charge is made, and the
  15. program and this document are unaltered. 
  16.  
  17. If you use this program please register by sending:
  18.     $20 U.S., check or money order OR
  19.     $20 Canadian, cheque or money order, OR
  20.     10 Pounds Sterling in Marks and Spencer's Gift Certificates,
  21. and any suggestions for improvements to the address listed below. Please
  22. specify the version number you are using (1.1). Your support will ensure that
  23. improvements are made. 
  24.  
  25.     4-319 Mackay St. 
  26.     Ottawa, Ont. 
  27.     K1M 2B7 
  28.  
  29.  
  30.                              First, a thank you.
  31.  
  32. This is a thank you to all of those users of VIEWGIF who have registered. Your
  33. support makes improvements like this release possible. Your feedback on
  34. VIEWGIF is invaluable. Without support VIEWGIF would still be at version 0.6.
  35. Note that if you are registered for a previous version of VIEWGIF you do not
  36. need to reregister for version 1.2. 
  37.  
  38.  
  39.                              Table of Contents: 
  40.     1.  WHAT'S NEW?                                                          1
  41.     2.  INTRODUCTION                                                         1
  42.     3.  FUNCTION OVERVIEW                                                    2
  43.         3.1 FILE - menu                                                      2
  44.         3.2 EDIT - menu                                                      3
  45.         3.3 MODE - menu                                                      5
  46.         3.4 Mouse Shapes                                                     7
  47.     4.  HOW TO USE VIEWGIF                                                   7
  48.         4.1 Guide to File Types                                              7
  49.         4.2 The COLOUR mode                                                  9
  50.         4.3 The GRAY mode                                                    9
  51.         4.4 The FL and CP8 formats                                          10
  52.         4.4 Use with SPECTRE 128/GCR                                        10
  53.         4.5 Overscan                                                        11
  54.     5.  KNOWN SHORTCOMINGS/BUGS                                             12
  55.     6.  ENHANCEMENTS UNDER CONSIDERATION                                    12
  56.     7.  PROGRAM HISTORY                                                     13
  57.     8.  REGISTRATION FORM                                                   17
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64. 1.  WHAT'S NEW?
  65.  
  66.     1.  A Full Screen mode has been added.
  67.             The entire ST screen can now be used to display images. By simply
  68.             pressing the escape key the image in the top window will replace
  69.             the entire screen. This feature only works in Native ST
  70.             resolutions. (ie. Full Screen Mode does not work with Overscan or
  71.             large screen monitors.)
  72.  
  73.     2.  Degas and Neochrome save uses Full Screen Mode to preview.
  74.             The image being saved can be adjusted using the Full Screen Mode
  75.             controls. Selecting the final clipping of a large image is now
  76.             much easier. The save is unchanged when using non native ST video
  77.             modes.
  78.  
  79.     3.  Much improved IFF file loading.
  80.             Version 1.1 had trouble understanding many IFF files. Version 1.2
  81.             can read many more IFF files.
  82.  
  83.     4.  An Added Bonus. NeoDesk 3.0 Icons.
  84.             The included .NIC file contains icons for use with NeoDesk 3.0.
  85.             Icons are provided for most of the filetypes VIEWGIF uses. Note
  86.             that the NeoDesk 3.0 documentation claims that 3.0 icons cannot be
  87.             used with earlier versions of NeoDesk.
  88.  
  89.  
  90.  
  91. 2. INTRODUCTION 
  92.  
  93.     So what are GIF files and why should I be interested? GIF files are
  94. computer graphic images stored in a compressed, hardware independent manner.
  95. The hardware independent format makes it a standard for moving images between
  96. different computers. 
  97.  
  98.     VIEWGIF allows your ST to show graphics created on a PC, an Amiga, or
  99. whatever, even if the original image has more colours or pixels than the ST
  100. can display. It also allows you to convert your Atari ST images into GIF
  101. format for exchange with other systems.  
  102.  
  103.     VIEWGIF is GEM based and operates in all three resolutions. Images are
  104. displayed in scrollable windows. Once an image is loaded it can be saved in
  105. NEO, Degas , Macpaint (in Monochrome) or FL Format. The image can also be
  106. cropped and shrunk to fit the ST screen. VIEWGIF also allows a GIF image to be
  107. directly transformed into AIM (the Atari Image Manager) and Spectrum 512
  108. pictures. This allows the 512 colour Spectrum mode to be used to display 256
  109. colour VGA images. 
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.                                           1
  117.  
  118.  
  119.  
  120.  
  121.  
  122. 3. FUNCTION OVERVIEW 
  123.  
  124.     Most menu items have keyboard equivalents which are noted at the end of
  125. each menu item. A caret (^) denotes a control key while a small triangle
  126. denotes an alternate key. The equivalents are listed with their corresponding
  127. functions in the list below. 
  128.  
  129. 3.1  FILE - menu 
  130.  
  131.     GIF INFO: (ALT I) 
  132.         Given a GIF file it displays the image attributes including dimension,
  133.         number of colours, size of colour palette, etc. It also tries to
  134.         determine the image's original video format. 
  135.  
  136.     LOAD FILE... (ALT L)
  137.         Displays the file load form. Allows the following file types to be
  138.         loaded:
  139.             GIF (ALT G), IFF (ALT A), LBM (ALT B), MAC (ALT M),
  140.             NEO (ALT N), DEGAS (ALT D), FL (ALT F), CP8 (ALT P).
  141.  
  142.         The keyboard equivalents can be used to bypass the file type selection
  143.         form.
  144.  
  145.         The GIF, IFF and LBM  modes read in the file and then translate it to
  146.         the current ST format according to the options set in the MODE menu.
  147.         The two modes are COLOUR and GRAY. (See discussion of MODE.) 
  148.  
  149.         The DEGAS mode currently reads uncompressed (PI#) DEGAS only.
  150.  
  151.         The MAC mode will read and translate into the current resolution any
  152.         MacPaint or Mac StartUpScreen image. Determination of image type is
  153.         automatic.
  154.  
  155.         The CP8 mode always uses the dispersed dot dither to translate the
  156.         image into the current ST format regardless of the MODE options COLOUR
  157.         and GRAY. (See CP8 discussion in TRANSFORM.) The dispersed dot dither
  158.         MODE options HISTO and SCALED are used. (See MODE discussion.) If the
  159.         file contains more than one channel (image) the user will be prompted
  160.         for the channel to load. The channel number appears after the filename
  161.         in the window border enclosed in square parenthesis.
  162.  
  163.         Each image is displayed in its own window and each window has its own
  164.         colour palette. The top window's colour palette is always used. The
  165.         original image dimensions are maintained but the CLIP and SHRINK
  166.         functions can be used to reduce the image size. The title bar of each
  167.         window contains the image filename and the information bar contains a
  168.         description of the image colours along with the dimensions of the
  169.         image. If the image is in colour then the information bar contains
  170.         [a:b] where 'a' is the number of colours in the original image and 'b'
  171.         is the number of Atari ST colours. If the image is displayed in gray
  172.         scale then the information bar contains [a:b] where 'a' is the number
  173.         of colours in the original image and 'b' is the number of grays in the
  174.  
  175.                                           2
  176.  
  177.  
  178.  
  179.  
  180.  
  181.         image.
  182.  
  183.     SAVE FILE... (ALT S):
  184.         Displays the file save form. Allows the following file types to be
  185.         saved:
  186.             GIF (CTRL G), FL (CTRL F), NEO (CTRL N),
  187.             DEGAS (CTRL D), MacPaint, (CTRL M),
  188.             Mac StartupScreen (CTRL T).
  189.  
  190.         The